Namespace definitions

The rell.test namespace is only accessible within test modules

Example

@test module;

function test() {
    rell.test.block().run();
}

Since

0.10.4

Types

block

type block

Represents a block builder which can build a block on the blockchain.

failure

type failure

keypair

struct keypair

Keypair that can be used for testing.

type op

Represent a operation that can be included in a transaction.

type tx

Represents a transaction builder that can build a block containing this transacation on the blockchain.

Properties

block_interval

val block_interval: integer

Time interval in milliseconds between current block and next block to be used.

BLOCKCHAIN_SIGNER_KEYPAIR

val BLOCKCHAIN_SIGNER_KEYPAIR: rell.test.keypair

Keypair that signs all blocks built in the test context.

DEFAULT_BLOCK_INTERVAL

val DEFAULT_BLOCK_INTERVAL: integer

Default time interval in milliseconds between each block. (10 seconds)

DEFAULT_FIRST_BLOCK_TIME

val DEFAULT_FIRST_BLOCK_TIME: integer

Timestamp in milliseconds of the first block by default. (2020-01-01 00:00:00 UTC)

last_block_time

val last_block_time: integer

Timestamp in milliseconds of the previous block. Read will fail if no block has been built.

last_block_time_or_null

val last_block_time_or_null: integer?

Timestamp in milliseconds of the previous block or null if no block has been built.

next_block_time

val next_block_time: integer

Timestamp in milliseconds which will be used for the next block.

Functions

assert_equals

function <T> assert_equals(actual: T, expected: T)

Asserts that two values are equal.

assert_events

function assert_events(expected: (text, gtv)...)

Asserts that the expected events has been emitted during last block

assert_fails

function <T> assert_fails(fn: () -> T): rell.test.failure

Asserts that a function fails to evaluate

function <T> assert_fails(expected_message: text, fn: () -> T): rell.test.failure

Asserts that a function fails with an expected message

assert_false

function assert_false(actual: boolean)

Asserts that the value is false.

assert_ge

function <T: -comparable> assert_ge(actual: T, expected: T)

Asserts that the value is greater than or equal to the expected value

assert_ge_le

function <T: -comparable> assert_ge_le(actual: T, expected1: T, expected2: T)

Asserts that the value is greater than or equal to the first value and less than or equal to the second value.

assert_ge_lt

function <T: -comparable> assert_ge_lt(actual: T, expected1: T, expected2: T)

Asserts that the value is greater than or equal to the first value and less than the second value.

assert_gt

function <T: -comparable> assert_gt(actual: T, expected: T)

Asserts that the value is greater than the expected value

assert_gt_le

function <T: -comparable> assert_gt_le(actual: T, expected1: T, expected2: T)

Asserts that the value is greater than the first value and less than or equal to the second value.

assert_gt_lt

function <T: -comparable> assert_gt_lt(actual: T, expected1: T, expected2: T)

Asserts that the value is greater than the first value and less than the second value.

assert_le

function <T: -comparable> assert_le(actual: T, expected: T)

Asserts that the value is less than or equal to the expected value

assert_lt

function <T: -comparable> assert_lt(actual: T, expected: T)

Asserts that the value is less than the expected value

assert_not_equals

function <T> assert_not_equals(actual: T, illegal: T)

Asserts that two values are not equal.

assert_not_null

function <T: -any> assert_not_null(actual: T?)

Asserts that the value is not null.

assert_null

function assert_null(actual: anything)

Asserts that the value is null.

assert_true

function assert_true(actual: boolean)

Asserts that the value is true.

get_events

function get_events(): list<(text, gtv)>

Get all events that have been emitted from the last block.

nop

function nop(): rell.test.op

Creates a new no-op operation.

function nop(x: byte_array): rell.test.op

function nop(x: integer): rell.test.op

function nop(x: text): rell.test.op

Creates a new no-op operation with a given nonce.

set_block_interval

function set_block_interval(interval: integer): integer

Set the time interval in milliseconds between current block and the next one. This property is not respected if a timestamp has been explicitly set by calling rell.test.set_next_block_time.

set_next_block_time

function set_next_block_time(time: integer)

Explicitly set the timestamp in milliseconds to use on the next block.

set_next_block_time_delta

function set_next_block_time_delta(delta: integer)

Explicitly set the timestamp in milliseconds to use on next block by specifying a time delay from the last block.